home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 36 / Amiga Format CD36 (1999-01-22)(Future Publishing)(GB)[!][issue 1999-02].iso / -seriously_amiga- / comms / other / henry / docs / faq.txt next >
Text File  |  1998-12-07  |  6KB  |  173 lines
  1.                                  The Henry FAQ
  2.                                        by
  3.                                  Rune Jacobsen
  4.  
  5.                           Last updated July 19th 1998
  6.  
  7. ================================================================================
  8.  
  9.                                     Contents
  10.  
  11. 1  This document
  12. 1.1   About the FAQ
  13. 1.2   Where to get it
  14.  
  15. 2  General Henry info
  16. 2.1   Why "Henry" ?
  17. 2.2   How is it compared to other bots?
  18. 2.3   Henry on the Internet
  19.  
  20. 3  Henry problems
  21. 3.1   Network problems
  22. 3.2   Misc problems
  23. 3.3   Programming problems
  24. 3.4   Configuration problems
  25.  
  26. ================================================================================
  27.  
  28. 1. This document
  29.  
  30.  
  31. 1.1   About the FAQ
  32.  
  33. This FAQ is currently maintained by Rune Jacobsen. The goal is to  have  a  nice
  34. collection  of  common questions, problems and solutions in one central place so
  35. that everyone can locate them easily.
  36.  
  37.  
  38. 1.2   Where to get it
  39.  
  40. Currently, the best place to get the FAQ is at the Henry  web  page  located  at
  41. http://fido.euroline.no/Henry/ - It's in the public Henry archive.
  42.  
  43. ================================================================================
  44.  
  45. 2  General Henry info
  46.  
  47.  
  48. 2.1   Why "Henry" ?
  49.  
  50. There have been a lot of trends going trough software naming  recently.  On  the
  51. Amiga  we  have  seen  Magic#?,  Am#? and Ami#?, and in the Microsoft controlled
  52. world one trend has been to name things after places. I just  thought  "Well,  a
  53. name is a name." So a name it is. Oh, and it was the name of the first commander
  54. of the 4077 M*A*S*H, who died, which was sad.
  55.  
  56.  
  57. 2.2   How is it compared to other bots?
  58.  
  59. As Henry is still in a relatively early beta version, we have  not  been  making
  60. any in-depth comparisons against any other bots yet.
  61.  
  62.  
  63. 2.3   Henry on the Internet
  64.  
  65. The Official Henry WWW Page: http://fido.euroline.no/Henry/
  66. Technical support email address: henrysupport@fido.euroline.no
  67. IRC: Look for Shitlips in Undernet #Henry or on ARCnet
  68. News: The author reads comp.sys.amiga.programmer semi-regularly
  69.  
  70. ================================================================================
  71.  
  72. 3  Henry problems
  73.  
  74.  
  75. 3.1   Network problems
  76.  
  77. Q: How come Henry fails so many connections before it manages to  log  on  to  a
  78. server?
  79.  
  80. A: There are two possible reasons for this. Both are related to the username you
  81. have configured your Henry to use. The first explanation is that you are already
  82. logged on to the IRC server with the same username with your  IRC  client.  Some
  83. servers do not allow multiple connections from one user@host (to avoid clonebots
  84. etc.). The second solution is that you use Miami, and you have confiugured Henry
  85. to  use another username than the one configured in Miami's TCP/IP-settings. The
  86. reason this is a problem is that most IRC servers use the identd  authentication
  87. daemon  to  verify  that Henry indeed is who he claims to be, and then won't let
  88. him in because the username is a "fake". The best solution to these two problems
  89. is  to  let  Henry use the username configured in Miami and use separate servers
  90. for Henry and your IRC client.
  91.  
  92. Q: Why does Henry stop working for a while when issuing an Aminet find request?
  93.  
  94. A: Currently, DNS lookups are performed in Henry's main process. When  the  host
  95. name  doesn't  exist  in the TCP/IP stack or DNS server cache, it has to be done
  96. over the net. This can be a bit slow. The first time Henry looks up  the  Aminet
  97. server,  it  will  be  locked.  This will be solved by a subprocess handling DNS
  98. lookups etc. in the future.
  99.  
  100. 3.2   Misc. problems
  101.  
  102. Q: Henry is brain damaged! I know <nick> has been on while Henry has been online,
  103. yet when I use the "Seen" command he says he doesn't exist in the user database!
  104.  
  105. A: To save on the database size, Henry does not automatically add  everyone  who
  106. joins  the  channel to the database. This must be done by either adding an entry
  107. in the Config/Users file manually, or by using AddUser / AddMask while Henry  is
  108. online.  In  future  Henries  there  will  be  a  possibility  for  new users to
  109. automatically add themselves to the userlist at default  access  /  file  levels
  110. (much like Eggdrop's "hello" command).
  111.  
  112. Q: Why are there no docs?
  113.  
  114. A: Because they take time to write. That's something I don't have very  much  of
  115. right now.
  116.  
  117. Q: But how do I set up my commands?
  118.  
  119. A: Study Config/Commands. It really isn't that hard, although I agree, docs  are
  120. definately needed. Soon, I promise.
  121.  
  122. Q: Can I be a beta tester?
  123.  
  124. A: No.
  125.  
  126. Q: Please?
  127.  
  128. A: No!
  129.  
  130. Q: How come Henry doesn't work on <#?>net?
  131.  
  132. A: There are incredible amounts of IRC networks popping up all around. Henry  is
  133. mainly tested on Undernet, but should work with most of them. However, there are
  134. of course some networks that run modified IRC-servers that  requires  additional
  135. login  information  to  be  sent or has specially modified commands/return codes
  136. that Henry knows nothing about. If you encounter one of  these,  please  let  me
  137. know at the Henry support address so I can look into it.
  138.  
  139. 3.3   Programming problems
  140.  
  141. Q: One of Henry's ARexx commands doesn't do what it should. What do I do?
  142.  
  143. A: Please mail your script along with comments on how to reproduce the error  to
  144. henrysupport@fido.euroline.no - I'll see what I can do.
  145.  
  146. Q: How do I make my own plugin for Henry?
  147.  
  148. A: Until the API  documentation  is  ready,  this  will  probably  require  some
  149. initiative  and experience on your part. What I can say is that you have to link
  150. your code with HPL.o as the FIRST object, and no compiler  startup  code.  Also,
  151. you have to open all libraries yourself, except exec, dos and graphics. When the
  152. Henry initialization stuff is done, the plugin code will  call  main()  in  your
  153. code. I hope to have some docs on this fairly soon.
  154.  
  155. 3.4   Configuration problems
  156.  
  157. Q: I have DefaultLevel set to 100, and I have an ARexx script with  PublicAccess
  158. set to 100, but the users with level 100 can't see the results of the command in
  159. public!?
  160.  
  161. A: You actually have to have an access level _higher_ than PublicAccess  of  the
  162. command  to  see  the  result  in  public.  Lower  the PublicAccess level of the
  163. command.
  164.  
  165. Q: How can I make Henry join several channels at once?
  166.  
  167. A: There is no way to  do  this  (that  will  work  properly)  currently.  Until
  168. otherwise  announced,  Henry is a single channel bot ONLY. I know there are ways
  169. to make it join several channels, but I also know that this WILL mess up lots of
  170. internal stuff, so stay away from it.
  171.  
  172.  
  173.